home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_3 / issue10 / hints / viewsheet / !ViewSheet / Instrucs < prev    next >
Encoding:
Text File  |  1993-11-29  |  14.9 KB  |  304 lines
  1.  
  2.      ==============================================================
  3.  
  4.      View, View Sheet and View Store ROM conversions for Archimedes
  5.  
  6.      ==============================================================
  7.  
  8.            This version 2.1 - For RiscOS 3.1 - October 1992
  9.  
  10.                    Copyright  D.J.Holden   Jan 1990
  11.  
  12.                          _______
  13.                     ____|__     |               (R)
  14.                  --|       |    |-------------------
  15.                    |   ____|__  |  Association of
  16.                    |  |       |_|  Shareware
  17.                    |__|   o   |    Professionals
  18.                  -----|   |   |---------------------
  19.                       |___|___|    MEMBER
  20.  
  21.  
  22.  
  23. This program is designed to convert the BBC ROM versions of View, View
  24. Sheet or View Store for the Archimedes with 6502 Emulator and to create a
  25. semi multi-tasking application for them to run from the desktop. This
  26. version will also work with the Compact/Archimedes disc based version of
  27. View and View Store. If you have used an earlier version of these
  28. programs you will be pleased to know that it now runs entirely from the
  29. RMA and does not need the application disc to be present once you have
  30. started !View or !ViewSheet.
  31.  
  32. Although there are separate applications for each of the programs,
  33. methods for converting the ROMS and their use is almost identical so this
  34. Instruction file is common to all applications. Where differences exist they
  35. will be noted. Where names or commands are different the first name will
  36. apply to View and the following name in brackets to ViewSheet and the third
  37. to ViewStore, eg. VIEW (VSHEET) (VSTORE)
  38.  
  39. As well as allowing the ROMs to run on the Archimedes this program will
  40. also give an improvement over the Compact and Archimedes versions because
  41. of the changes which have been made.
  42.  
  43.  
  44. 1.    The pound key works correctly and returns ascii 96 to make it file
  45.       compatible with BBC files. The left "'" key is translated to a
  46.       right "'" for the same reason. The pound symbol is therefore
  47.       correctly displayed on screen if you are editing an old BBC file.
  48.       If you are using View B3.01, which is the Master Compact version and
  49.       is also sold for the Archimedes, then if you want to make the Pound
  50.       compatible with the Archimedes character set rather than the BBC
  51.       use SHIFT-Pound. This will give the Archimedes pound character
  52.       (ascii 163). Either of these will still be displayed correctly on
  53.       the screen but if you use the Archimedes pound then you will need
  54.       to change your printer driver.
  55.  
  56. 2.    The function keys are in the right place, ie. you no longer need
  57.       to press the PRINT key to format a paragraph and your BBC keystrip
  58.       needs simply be cut into three pieces and stuck to a piece of card
  59.       to be correct for the Arc.
  60.  
  61.  
  62. To use the program with a ROM you must get a copy of your BBC ROM onto an
  63. Archimedes disc. For obvious copyright reasons I can't supply this. Then
  64. carry out the following procedure
  65.  
  66.  
  67. 1.    Open the application directory by holding down SHIFT and double
  68.       clicking on the icon. Copy your BBC ROM image into the directory
  69.       and make sure that it is named VIEW (VSHEET) (VSTORE), rename it if
  70.       necessary.
  71.  
  72. 2.    Double click on the '!Convert' icon and a new file 'ViewMod'
  73.       (VSheetMod) (VstoreMod) should appear. If the program doesn't
  74.       recognise the version of View, ViewSheet or ViewStore that you have
  75.       then an error message will be displayed. You will then be given the
  76.       option of attempting a conversion on the unrecognised ROM. If this
  77.       happens and the conversion isn't sucessful then if you send me a copy
  78.       of your ROM (with return postage/label please) I will try to amend the
  79.       program to accommodate it.
  80.  
  81. 3.    Once you have created ViewMod, VSheetMod or VstoreMod the original
  82.       ROM copy and the !Convert application are no longer required so
  83.       they can be deleted from your working copy of the application.
  84.  
  85. 4.    You will need a copy of 65Tube 6502 emulator in the application
  86.       directory. If this is not present in the program supplied to you
  87.       copy it from your Applications Disc 2. If you have a hard disc you
  88.       probably won't want to put the emulator in the application
  89.       directory. In this case alter the line in the !Run file which loads
  90.       the emulator to point to wherever you keep 65Tube.
  91.  
  92.       On RiscOS3 application discs it is no longer called (sensibly)
  93.       65Tube but is the file !Runimage in the 65Tube application. In
  94.       this case copy the !Runimage file to the !View(etc) application
  95.       directory and rename it 65Tube. If you have a hard disc you
  96.       probably won't want to put the emulator in the application
  97.       directory. In this case alter the line in the !Run file which
  98.       loads the emulator to point to wherever you keep 65Tube. Once
  99.       again because of Acorn's brainstorm of renaming the 65Tube Module
  100.       !Runimage (to conform to one of their most stupid ever standards)
  101.       you shoulc alter the line to RMLOAD [path].!Runimage. DONT just
  102.       RUN the 65Tube application as this will actually start up the
  103.       Emulator which is not what is wanted at this stage.
  104.  
  105. 5.    The !Run file on the application directory is changed during this
  106.       process. If you wish to pass on copies of this program to anyone you
  107.       will therefore need to restore the original !Run file. A copy of this
  108.       can be found in the !Convert directory called 'Old!Run'. Just delete
  109.       the new !Run file in the !WordWise directory, copy the file Old!Run
  110.       into this directory and rename it !Run.
  111.  
  112. As well as these programs for the View 'family' there are similar
  113. utilities for Interword, (Archimedes disc version), InterSheet, (BBC ROM
  114. version), WordWise Plus (Archimedes disc version). If you have one of
  115. these programs then contact me to ask for details. If you have any other
  116. BBC ROMs that you wish to use on the Archimedes then if you send me a
  117. disc with a copy of the ROM (and an SAE please) I will try to help.
  118.  
  119. Please note that in order to make this application work I have been
  120. forced to use some 'crude and dirty' programming methods. Normally this
  121. is transparent to the user and doesn't cause any difficulty.
  122.  
  123. I offer no warranty for the operation of this program, nor will I 
  124. accept any responsibility for its operation or suitability for any
  125. purpose or for any damage or loss of data caused by its use.
  126.  
  127.  
  128.       Using !View, !ViewSheet or !ViewStore
  129.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  130. If you double-click on the application icon it will install itself on the
  131. icon bar just like any other RiscOS application. If you click 'Menu' (the
  132. middle mouse button) on this icon a menu will appear with the usual
  133. 'Info' and 'Quit' items. If you click 'Select' on the icon you will start
  134. up View, ViewSheet or ViewStore at the Command screen.
  135.  
  136. When you are finished and want to return to the Desktop DON'T PRESS RESET
  137. Remember that the program is a semi multi-tasking application. The
  138. desktop is still there, you just can't see it because View, ViewSheet or
  139. ViewStore takes over the whole computer temporarily. To return to the
  140. Archimedes desktop type *QUIT (or *Q.) at the command screen and you will
  141. return to the desktop to find all your other applications just as you
  142. left them. The only problem is when you do this you will lose any data in
  143. View or ViewSheet so remember to SAVE it BEFORE returning to the desktop.
  144.  
  145. To start up View, ViewSheet or ViewStore with a file loaded just drag the
  146. file icon to the icon on the icon bar. As these programs don't save files
  147. with an Archimedes filetype there is no way of checking if it is
  148. suitable. With !ViewSheet and !ViewStore it is assumed that you know what
  149. you are doing and that the file is a valid ViewSheet file, so it will
  150. simply be LOADed. With !View the following convention is adopted. If the
  151. file is type &FFF (Text), &FEB (Obey), &FFE (Command) or &FFD (Data) then
  152. it will be READ into View. Any other type will be assumed to be a valid
  153. View file and will be LOADed.
  154.  
  155. Remember that text files on the Archimedes normally have a linefeed
  156. (ascii 10) at the end of each line whereas View requires a cr (ascii 13).
  157. If you want to load a text file into View load it into Edit first and
  158. press CTRL-F8 to change the linefeeds to cr's. Then save the file again
  159. and drag it to the View icon.
  160.  
  161. When you drag a file to the View or ViewSheet icon the Current Directory
  162. is set to the directory the file is in so you can easily save it again.
  163. You can also load other files in the same directory without needing to
  164. type a path.
  165.  
  166. When you drag a file to ViewStore the current directory is set to the
  167. PARENT directory of the file you have dragged. This is because ViewStore
  168. expects the disc layout to conform to a certain pattern with files in
  169. specific sub-directories. For this to work correctly you must therefore
  170. have set up your directory structure correctly. If you are familiar with
  171. Viewstore you will already know how to do this.
  172.  
  173. If you drag a directory instead of a file to the icon View or ViewSheet
  174. will be started with no file loaded but the Current Directory set to the
  175. directory you dragged to the icon. You can therefore easily load any file
  176. in that directory or create a new file and save it to that directory.
  177.  
  178. The same method is used with ViewStore but in this case you should drag
  179. the icon of the directory which contains the F, D, etc sub directories
  180. required by ViewStore.
  181.  
  182.  
  183.       The Setup file
  184.       ~~~~~~~~~~~~~~
  185. When you first start up !View, !ViewSheet or ViewStore it will look in
  186. it's application directory for a Text file called 'Setup'. This file can
  187. hold any commands that you can type at the Command Screen and these
  188. commands will be activated each time you start the application. You can
  189. enter SETUP commands, load a printer driver, remembering that you will
  190. also need the full path, or any other valid commands. Each command should
  191. be on a new line. You can put comments in the file as anything on a line
  192. after a backslash (\) will be ignored. DON'T use the Setup file to try to
  193. enter VDU codes to set screen mode, colours etc. A different system is
  194. used for these.
  195.  
  196. The Setup file must be less than 512 bytes long which should be enough
  197. for all the commands you require plus comments. If you don't use a Setup
  198. file then a default command of SETUP FI is included in the ViewMod Module
  199. and this will be used for View. The VSheetMod and has no default
  200. commands.
  201.  
  202.  
  203.       The VIEWSCREEN (VSHEETSCREEN) command
  204.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  205. With the BBC versions it is usual to put VDU codes in a 'Startup' EXEC
  206. file to set screen mode and colours. The equivalent of this with !View
  207. !ViewSheet and !ViewStore is a '*' command built in to the Module which
  208. runs the ROM. This command is followed by a string of VDU codes and when
  209. the program is started these codes are sent to the vdu drivers. This
  210. command can be used by pressing F12 and entering the command at the
  211. keyboard or by placing the command in the !Run file after the command to
  212. load the Module. Load the !Run file into Edit to see how this is done.
  213.  
  214. If you don't use this facility then a default code sequence will be used
  215. which switches to Mode 12 with white text on a dark blue background.
  216.  
  217. The VDU codes follow the *VIEWSCREEN (*VSHEETSCREEN) (*VSTORESCREEN)
  218. command separated by commas and/or spaces. They must all be on the same
  219. line. You can use any valid VDU codes (see the User Guide for details)
  220. but no checks are made to see that they are valid or correct so be
  221. careful. It is probably best to try them out with the *VIEWSCREEN
  222. (*VSHEETSCREEN) (*VSTORESCREEN) command at the keyboard before you put
  223. them in your !Run file. The maximum number of codes permitted is 128
  224. which should be sufficient.
  225.  
  226. If you don't want any VDU codes then *VIEWSCREEN 0 (*VSHEETSCREEN 0)
  227. (*VSTORESCREEN 0) will send nothing. In this case you will get black text
  228. on a white background and the desktop Mode. To see the current codes just
  229. type *VIEWSCREEN (*VSHEETSCREEN) (*VSTORESCREEN).
  230.  
  231.  
  232.       Licence to Use and Copy
  233.       ~~~~~~~~~~~~~~~~~~~~~~~
  234. THIS PROGRAM IS NOT PUBLIC DOMAIN. The program and all associated
  235. material including this file are all Copyright D.J.Holden.
  236.  
  237. Anyone may make PERSONAL use of the programs without restriction. Use for
  238. any EDUCATIONAL, COMMERCIAL or TRAINING purposes is FORBIDDEN without my
  239. permission. This will normally be granted without charge or limitation.
  240.  
  241. You may only copy and/or distribute the program strictly subject to the
  242. following conditions.
  243.  
  244. 1.    You must copy the compete !View, !ViewSheet or !ViewStore
  245.       application with all it's auxiliary files, !Run, !Boot, Setup,
  246.       Instruc, ViewProg, !Sprites, Templates and the !Convert
  247.       application.
  248.  
  249. 2.    You must not make any alteration to any of these files although you
  250.       may modify the !Boot and !Run files if necessary to suit your
  251.       distribution discs.
  252.  
  253. 3.    You must ensure that you do not copy a ViewMod, VSheetMod or
  254.       VStoreMod file as this will contain code which is copyright
  255.       Acornsoft and must be provided by the user. I take no
  256.       responsibility for any breach of Copyright by this means and by
  257.       using or copying the programs you are obliged to accept liability
  258.       for ensuring that no breach of Copyright occurs in this manner.
  259.  
  260. 4.    You must not make any charge for the program or for any additional
  261.       material that you might supply. You may make a charge to cover
  262.       media, postage, overheads, etc.
  263.  
  264. 5.    If you are running a P.D. library or are otherwise making any
  265.       charge for copying this program, whether in fee or in  kind, even
  266.       if this fee is donated to charity, you are obliged to notify me
  267.       that you are distributing !View, !ViewSheet or !ViewStore. I would
  268.       appreciate a disc with a selection from your Library and I will
  269.       respond by sending you the latest version and a selection of
  270.       others.
  271.  
  272.  
  273.       Other BBC ROMs
  274.       ~~~~~~~~~~~~~~
  275. There are similar applications for the disc based versions of Interword,
  276. Intersheet and WordWise Plus. If you have any other BBC ROMs that you are
  277. having problems with on the Archimedes or if you cannot get your version of
  278. View, ViewSheet or ViewStore to work with this then send me a copy of the
  279. ROM, with an SAE please, and I will try to help.
  280.  
  281. For this or any other problems or suggestions for improvements please
  282. contact me;
  283.  
  284.                    David Holden
  285.                    39 Knighton Park Road
  286.                    Sydenham
  287.                    London SE26 5RN
  288.  
  289.                    081 778 2659
  290.  
  291.  
  292.  
  293.         ASP Message
  294.         ~~~~~~~~~~~
  295. This program is produced by a member of the Association of Shareware
  296. Professionals (ASP). ASP wants to make sure that the Shareware principle
  297. works for you. If you are unable to resolve a shareware related problem
  298. with an ASP member by contacting the member directly, ASP may be able to
  299. help. The ASP Ombudsman can help you resolve a dispute or problem with
  300. an ASP member, but does not provide technical support for members'
  301. products. Please write to the ASP Ombudsman at 545 Grover Road,
  302. Muskegon, MI 49442-9427, U.S.A.  or send a CompuServe message via
  303. CompuServe Mail to ASP Ombudsman 70007,3536 or FAX 616-788-2765. 
  304.